home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / packet / aprs75c / digitizr.txt < prev    next >
Text File  |  1996-04-16  |  10KB  |  200 lines
  1. DIGITZR.txt 7.5c     USING DIGITIZERS FOR DRAWING MAPS!
  2.                      by Ken Swaggart W7KKE and WB4APR
  3.  
  4.  
  5. With the help and inspiration of Ken W7KKE, MAPFIX.bas now lets you rapidly
  6. digitize maps and see the map on the screen as you draw it.  Most of the
  7. instructions on using the digitizer within MAPFIX are included in that
  8. program.  But the following is a more detailed set of set up ideas and
  9. cautions..  A common Microsoft SERIAL PORT mouse can also be used as a
  10. digitizer!  See MOUSE.txt.
  11.  
  12. The program should work with any Digitizer that outputs individual POINT
  13. coordinates in the format XXX,YYY,C.  Where XXX and YYY are ASCII numeric
  14. values from 3 to 5 digits in length, and C may contain ASCII characters
  15. indicating the status of the PEN, Mouse, or Buttons on the mouse.  The
  16. digitizer should operate in the POINT mode, so that a data point is only
  17. output when the operator presses a button or puts the PEN to the digitizer
  18. surface.  The characters included in C are only used, if they end with the
  19. numeral "3", which is the 4th button on a 4 button digitizer mouse.  With this
  20. type of mouse, you can use button 1 for adding points (the default mode), or
  21. button 4 to move the cursor with no action...
  22.  
  23. The program is set up to operate at 9600,N,8,1.  To use the digitizer in 
  24. MAPFIX, you must issue the FILES-OPEN command to OPEN the COMM port
  25. for the digitizer.  Once the plotter is initialized, entering a point with the
  26. digitizer will always ADD a new point immediately after the current point
  27. indicated by the small white circle.  Use EDIT-BEGIN to begin a new map 
  28. feature with the Digitizer.  This command prompts you for the name
  29. of the new feature and then will use the first tablet point as the STARTing
  30. point.  All future clicks of the mouse add to this feature.  You can also
  31. use the traditional EDIT-NEW comand with the mouse, but you must FIRST move
  32. the cursor to the starting point before doing EDIT-NEW.  MAPFIX has
  33. HOTKEYS F4, F7, F8, F10 etc for beginning new features with a single key 
  34. stroke.
  35.  
  36.   1. Place a map, or map section, on the plotter.  It should be a Mercator
  37. projection with lat and long lines parallel with edge of plotter.  MAPFIX
  38. will calibrate itself with the location of the map, but the map must be
  39. alligned so that a LAT line gives the same Y reading on both sides of the
  40. digitizer surface.
  41.  
  42.   2. MAPFIX aligns to the scale of the MAP by having you choose a lat/long
  43. in the vicinity of the upper left map corner and the lower right corner.
  44. These points are used to calibrate the plotter surface to the map.  If your
  45. map is not a perfect MERCATOR, you can minimize the error by NOT choosing the
  46. extreme corners of the map, but choose points closer to your area of operation,
  47. say in the center of the upper left Quadrant and the center of the lower right
  48. quadrant.
  49.  
  50.   3. Run MAPFIX.  To start a NEW map from scratch, type NEW when asked for
  51. a map filename.  You must then select the LAT/LONG of your origin for your map
  52. and a scale in Pixels-per-degree.  Note that finer and finer resolutions make
  53. smaller and smaller maps since there is a limit to the data values stored for
  54. each data point.  When asked for a LAT/LONG in decimal degrees, decimal
  55. fractions are fine. IE: 35.6 or 124.55, etc.  When asked for LAT/LONG in
  56. degrees and minutes, separate the degrees and minutes with a COMMA such as
  57. DD,MM.xx where minutes can be entered with decimal fractions if needed.
  58.  
  59.   4. Each map feature prompts for a feature name to ease in any debugging.
  60. Then just point to each position you wish to digitize. The program beeps and
  61. displays the converted data on the screen.  After each point is added, any
  62. other MAPFIX command may be used.  In otherwords, if you dont like a point
  63. that you just entered, just hit EDIT-DELETE, or EDIT-MOVE to MOVE it!
  64.  
  65.   5. Add Labels to the map at any time by moving the cursor to the desired
  66. map location, and pressing LABELS-ADD.  Remember that the names are right 
  67. justified so that the label will appear to the left of the point specified.
  68.  
  69.   6.  Remember to save your map occassionally using the Ctrl-S command.  After
  70. each save, you can just continue on with the next point, or QUIT the program.
  71. If things get screwed up, hit the SPACE bar to re-draw the map.  If they are
  72. still screwed up, consider saving the map, and using an EDITOR to check things
  73. out and fix them according to the definition of a map given in README.MAP.
  74.  
  75. NOTE:  APRS and MAPFIX have troubles with a feature with only one point.
  76. They are seen as straight lines to the ORIGIN.
  77. Occassionally these get in there and you must remove them with a DOS text
  78. editor.  If you try deleting them on-line within MAPFIX, you may delete whole
  79. other features and loose a lot of points.  Sometimes these problem features
  80. are generated when you try to digitize a point which results in a ZERO value
  81. of X.  That really screws things up!  Be careful around the yellow vertical
  82. line that is the X origin!  The C command scans the file and gets rid of 
  83. single point anomolys.  Also, if you can hook one, then EDIT-KILL will work
  84. to kill it.
  85.  
  86.   7.  To add your new map to APRS, add the map file to your APRS MAPS 
  87. directory, and then use an EDITOR to add the MAPNAME, center decimal 
  88. coordinates, and range to the desired MAPLIST.xxx file.  You may need to 
  89. suppress some of the existing maps in the distro version of MAPLIST.xxx,
  90. by placing a * at the beginning of the map name, in order to keep the 
  91. total number of active maps in your list below the 170 limit.  Remember 
  92. that you must place the new map in the proper order (more detailed maps 
  93. must follow bigger maps that cover the same area) to get the right map 
  94. to display when you have overlapping maps.  While running APRS,
  95. if maps overlap, you can temporarily look at a map beneath a map by hitting
  96. MAPS-ALT.  Then remember to fix the order of the maps in your MAPLIST.apr
  97. file later on to customize the list to your satisfaction.
  98.  
  99.  
  100. MOVING THE PAPER MAP ON THE TABLET, OR RESETTING THE TABLET TO ANOTHER MAP
  101.  
  102. This is surprisingly simple!  FIrst do a FILES-SAVE to save what you have 
  103. already (in case Murphy drops by).  Then without even stoppping the program, 
  104. just place the new paper map on the digitizer and do another FILES-OPEN.
  105. MAPFIX will re-set the coordinates to the new map, and you can just
  106. keep on digitizing!  This is neat, when you have 4 or 6 of the 24,000 scale
  107. maps that you are going to use to build ONE APRS map file.  This capability
  108. is also very useful if you are using a 12inch by 12 inch digitizer tablet
  109. and need to move a single paper map 4 times to get all the data off of it!
  110.  
  111.  
  112. CALCOMP DRAFTING TABLE MODEL 23360 (Used by WB4APR):
  113. ----------------------------------------------------
  114. Use the onboard menu labels and mouse button 0 to configure the digitizer as
  115. indicated above and in the prompts within MAPFIX.  I set it up for 200 LPI
  116. since that is more than adequate.  Plug in the serial port, run MAPFIX.bas and
  117. start drawing!  Do not get too fussy with lots of dots, remember that there is
  118. a 2999 point limit in APRS, so don't waste points with fancy curves where
  119. three points will do!
  120.  
  121. MOUSE:  Notice, that a standard Microsoft SERIAL COM port mouse can be used
  122. as a poor-mans-digitizer!  See MOUSE.txt
  123.  
  124.  
  125. SUMAGRAPHICS MMII 1812 digitizer tablet:  
  126. -----------------------------------------
  127. Use the sumagraphics SEND.COM program to configure the tablet as follows:
  128.  
  129. SEND /1 /S96 /Czaz8c8cFBe
  130.  
  131. For more info on these tablets contact W2g3zfj@unix.asb.com and/or
  132. WJ8T snabkey@wingsbbs.com.
  133.  
  134.  
  135. CALCOMP Model 4110 Plotter (Used by W7KKE):
  136. -------------------------------------------
  137.  
  138. Data is serial ASCII, even parity, with 4 characters of x position and 5
  139. characters of Y.   W7KKE thinks the 1st Y character is pen status.
  140. (if so, he is gonna have to modify MAPFIX to make it work)
  141.  
  142. Power input is pin 24 +12vdc at 290-300 ma. Pin 25 is power return.
  143.  
  144. Data Ranges:  X: 0=left  4000=right   y: 0=bottom  4000=top
  145.  
  146. Pen status:  0 = point mode  1 = run mode, pen down   9 = run mode, pen up
  147.  
  148. Set the "A/B" switch on back next to the D25 plug to B for POINT mode
  149.  
  150. Pin connections:
  151. 1    NC
  152. 2    +/- 15 v RS-232 data output from plotter.
  153. 3    + 5v from board (probably for some original interface device)
  154. 4    "             "                      "
  155. 5    0/+5v TTL data output
  156. 6    "                "
  157. 7    Ground (data return)
  158. 8-11 baud rate.
  159. 12 - 23 Unknown. Appear to be open.
  160. 24   +12 vdc  power input
  161. 25   ground
  162.  
  163.  
  164. BAUD RATE PROGRAMMING PINS:
  165.  
  166. BAUD RATE      8     9     10     11   (X = connection to GND)
  167.  
  168.   1200         .     X      .     .
  169.   4800         .     X      X     .
  170.   9600         .     X      X     X    (use this for MAPFIX.bas)
  171.  
  172.  
  173.  
  174. TEKTRONIX 4957 GRAPHIC TABLET (used by WA1VJH):
  175. -----------------------------------------------
  176.  
  177. INITIALIZATION STRING: ESC Z, ESC Q, ESC M1, ESC F3, ESC C0, ESC x
  178.  
  179. ALSO, MAPFIX.BAS WILL HAVE TO BE MODIFIED AS FOLLOWS TO ACCEPT THE DATA
  180. STRING FROM THE 4957:  Use the SEARCH-FIND command to find them
  181.  
  182.  FROM: digix1 = 5000 - VAL(LEFT$(a$, 5))
  183.    TO: digix1 = 5000 - VAL(MID$(a$, 2, 5))
  184.  FROM: digiy1 = VAL(MID$(a$, 7, 5))
  185.    TO: digiy1 = VAL(MID$(a$, 8, 5))
  186.  FROM: digix2 = 5000 - VAL(LEFT$(a$, 5))          
  187.    TO: digix2 = 5000 - VAL(MID$(a$, 2, 5))
  188.  FROM: digiy2 = VAL(MID$(a$, 7, 5))
  189.    TO: digiy2 = VAL(MID$(a$, 8, 5))
  190.  FROM: x = 5000 - VAL(RIGHT$(a$, a - 1))
  191.    TO: x = 5000 - VAL(MID$(a$, 2, a - 1))
  192.  FROM: y = VAL(MID$(a$, a + 1, B - (a)))
  193.    TO: y = VAL(MID$(a$, a + 2, B - (a)))
  194.  FROM: Btn = VAL(RIGHT$(a$, 1))
  195.    TO: Btn = VAL(MID$(a$, B + 1, 2))
  196.  
  197. ALSO NOTE THAT THE 4957 BUTTON NUMBER 3 WILL FUNCTION IN PLACE OF THE         
  198. DESCRIBED MAPFIX BUTTON 4 DUTIES.   DE GARNET/WA1VJH
  199.  
  200.